home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / cli / MJoinDOC.lha / MJoin.doc
Text File  |  1995-01-19  |  4KB  |  119 lines
  1.  
  2.                                    MJoin V1.0 
  3.                             © 1995 by Harald Löffler
  4.  
  5.      PREFACE 
  6.  
  7.      The programs and files in this distribution are freely distributable, 
  8.      but are also Copyright © Harald Löffler. They may be freely distributed
  9.      as long as no more than a nominal fee is charged to cover time and
  10.      copying costs. No commercial usage is permitted without written permission
  11.      from the author. Everything in this distribution must be kept together, in
  12.      original unmodified form. The only thing I ask for is to send me a mail and
  13.      tell me, what you think about MJoin.
  14.      The above is generally known as mailware.  
  15.  
  16.  
  17.  
  18.      1. Introduction 
  19.      --------------- 
  20.  
  21.      For all those that frequently have to join files with a similar basename,
  22.      probably splitted by bsplit, split etc., I´ve written this little tool.
  23.      It can do this job in a very easy way. 
  24.                                Hope ya like it ;-)
  25.  
  26.  
  27.  
  28.      2. Installation
  29.      ---------------
  30.  
  31.      Just copy MJoin to your C: directory and the doc to your favourite DOC-dir.
  32.      That´s all.
  33.  
  34.  
  35.      
  36.      3. How to use it
  37.      ----------------
  38.  
  39.      The easiest way is this one:    MJoin basename.foo
  40.      
  41.      This will join all files beginning with basename.foo followed by a number.
  42.      Using MJoin this way will join all files from number 0 on until the following
  43.      file doesn´t exist anymore, e.g. You have basename.foo0, basename.foo1 and
  44.      basename.foo3, only the first two files will be joined.
  45.      In other purpose you have to use the various parameters.
  46.  
  47.  
  48.  
  49.      4. The parameters
  50.      -----------------
  51.      
  52.      The general form is:
  53.      
  54.      MJoin <basename> [FROM start] [UPTO end] [AS newname]
  55.                       [NOFRAC|NULL|QUIET|FORCE]
  56.  
  57.      Where FROM means the first number to search for, analogous means UPTO the last
  58.      number to join. If you use the UPTO Parameter MJoin will go on until this number
  59.      is reached, even if some files do not exist. If you want MJoin to stop in that
  60.      case you have to use NOFRAC. This causes MJoin to stop at the first non existing
  61.      file in the row.
  62.      
  63.      With AS you can specify a name for the file that will be created, if not the
  64.      basename (without the number of course) will be used. If the AsName allready
  65.      exists a warning will be displayed and you can use FORCE to overwrite it.
  66.  
  67.      The QUIET option forces MJoin to stop all printouts unless there is something
  68.      wrong with the parameters.
  69.  
  70.      The NULL option is something special. If you use bsplit, you get files in the
  71.      following form: 00 01 02 03 ... 10 11 ... and so on. This files do not have a
  72.      real basename. So if you choose the NULL-Parameter you can join them by giving
  73.      a dummy basename. But you have to specify an AsName for them.
  74.  
  75.  
  76.  
  77.      5. DISCLAIMER
  78.      -------------
  79.      
  80.      This program is released as is. No warranty on any damage or misfunction.
  81.      Use it or kick it.
  82.      
  83.      
  84.      
  85.      6. Author, bugs, to do´s, etc.
  86.      -----------------------------
  87.  
  88.      Stuff I want to do in future: Tell me what you want!
  89.  
  90.      I´ve included the source, though you can easily port it to any platform, that
  91.      supports ANSI-C. The only thing you have to do is delete the following lines
  92.  
  93.        #include <exec/types.h>            /* BOOL etc. Type-Definitions     */
  94.        #include <dos/dos.h>               /* Definition of RETURN_FAIL etc. */
  95.  
  96.      and add this ones
  97.  
  98.        #define BOOL int
  99.        #define TRUE (0 == 0)      /* Sorry, forgot this in prev. release */
  100.        #define FALSE (0 == 1)
  101.        #define RETURN_OK                 0
  102.        #define RETURN_WARN               5
  103.        #define RETURN_ERROR             10
  104.        #define RETURN_FAIL              20
  105.  
  106.  
  107.      If you have found some of this ugly bugs :( , want to make some suggestions :)
  108.      or tell me :-) something else, write to:
  109.  
  110.  
  111.          _/    _/     _/       Harald Loeffler
  112.         _/    _/     _/        Schenkenbergstrasse 12
  113.        _/_/_/_/     _/         73733 Esslingen / GERMANY
  114.       _/    _/     _/                
  115.      _/    _/     _/_/_/_/     e-mail: harry@studbox.uni-stuttgart.de
  116.  
  117.  
  118.      If possible, please use e-mail.
  119.